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1. INTRODUCTION 


GENERAL 


This manual describes the sort/merge routine provided for use with the UNIVAC 8410 
Disc Sort Package and the UNIVAC 9200/9200 II/9300/9300 II Systems. The manual 
was written on the premise that the reader has a thorough understanding of the 
following: 


m UNIVAC 9200/9200 II/9300/9300 II Systems Tape/Disc Assembler Programmer 
Reference, UP-7508 (current version); 


m UNIVAC 9200 II/9300/9300 IT Systems Magnetic Tape Subsystems IOCS Programmer 
Reference, UP-4135 (current version); 


mu UNIVAC 9200/9200 II/9300/9300 II System Operating System Programmer Reference, 
UP-7531 (current version); 


a UNIVAC 9200/9200 II/9300/9300 II Systems Minimum Operating System Programmer 
Reference, UP-7547 (current version). 


The minimum equipment configuration for using the Sort package is: 
m One UNIVAC 9200/9300 Central Processor 

m 12,288 bytes of storage 

a One 400/600 CPM card reader 

mw One 8410 Disc File Control 

m Two 8410 Disc File Handlers 


The Sort can use up to 32,768 bytes of storage with a maximum of eight disc file 
handlers, 


On card systems, the disc sort operates in conjunction with the Minimum Operating 
System and the disc dispatcher. On tape or disc systems, the Sort can be loaded from 
a library file. 


SORT PACKAGE PROGRAMS 


The Sort package contains a record sort program, a tag sort program, and a merge 
program. (The merge is a separate program distinct from merge coding, which is a part 
of a sort program.) 


1.2.1. Record Sort 


A record sort results in a file of records arranged in a physical sequence according 
to the collating order of a key field in the records. 


A record sort operation requires, three discs: input, output, and work. If only two 
disc drives are available, one drive is used first as an input disc and subsequently 
as an output disc. The operator is informed by a display when to replace the input 
disc. The Sort operation continues using an output and a work disc. 
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1.2.2. Tag Sort } 


A tag sort results in a file consisting of disc addresses only, disc addresses and 
their associated key fields, or an entire record. 


The tag sort requires a minimum of two disc handlers to produce a file of disc 
addresses or when user own code is included; three disc handlers are required if 
the output file is to contain complete records. 


1.2.3. Merge Program 


The Merge program combines two or more‘sorted files into one'sorted file. Files 
that are segmented because of time or hardware limitations can be merged into 
one file at a convenient time. 


Each merge input file is assumed to have identical characteristics. A record that 
is out of sequence in an input file results in a program halt and a display indicat- 
ing the logical unit number of the input file containing the record that is out of 
‘sequence, 


1.3. PROCESSING CAPABILITIES 


1.4. 


The Sort and the Merge programs process sequential or direct-access files. The 

operator is alerted by a display before a direct-access file is processed. Indexed 
‘sequential files can be processed by using own code to access records from the 
indexed sequential file and delivering the record to the Sort program. 


Fixed-length blocked or unblocked records, and variable-length unblocked records 
are ‘sorted. The maximum record length is 160 bytes. The first four bytes of a vari- 
able-length record must contain record length information. 


The field used for the sorting procedure can be made up of a maximum of 12 key 
fields in a record. Key fields can be alphanumeric, unpacked decimal, packed 
decimal, or ‘signed binary data; key fields can be‘sorted in either ascending or 
descending sequence. The size limitations of a key field are-specified in the 
FIELD statement (see 2.7). 


INFORMATION SUPPLIED TO SORT 


The programmer provides statement cards for the Sort and the Merge programs. 
Statement cards contain information required to direct the Sort or the Merge opera- 
tion. The information describes input and output file requirements, label specifica- 
tions, available work (scratch) discs, and the key fields. 


Optionally, the programmer provides own code routines to perform input and output 
operations and functions otherwise controlled by the Sort or the Merge program, Own 
code routines perform the following functions in addition to the normal Sort opera- 
tions: file-reduction (combining information from two records containing the same 
key fields), read error control, and sequencing of records, 


The method of transferring program control between own code and Sort program is 


described in the following sections. 





UP-7651 . 
Rev. 1 UNIVAC 9200/9300 DISC SORT sehoste ee 





} 1.5. SORT AND MERGE PROGRAM ORGANIZATION 


The organization of the record sort, tag sort, and merge sort card decks is as follows: 


Record or Tag Sort 


CARD 
DECK 





A = Phase 0 (PHOL or PHO) 

B = Statement cards with a blank card following 

C = Relocator phase (PHRL or PHL) —- optional 

D = Own code modules with /* END card and a blank card following (optional) 
E 

F 

G 





= Phase 1 
= Phase 2 
= Phase 3 
Merge: 
CARD 
DECK 
A = Phase 0 (PHOL or PHO) 
B = Statement cards with a blank card following 
C = Relocator phase (PHRL or PHL) — optional 
D = Own code modules with /* END card and a blank card following (optional!) 
H = Phase 4 (merge only) 


See 


Card decks A, C, E, F, G, and H constitute the self-loading sort setup and operating 
coding. However, this does not preclude the necessity of loading the Minimum Operating 
System (MOS) supervisor with the Disc Dispatcher before the Sort is loaded. 
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Figures 1-1 and 1-2 show where the statement and own code decks are inserted in the 


Sort and the Merge programs. 










BLANK CARD 
BLANK CARD 

Bre 3 

(RECORD/TAG SORT) 


= 2 


(RECORD/TAG SORT) 


(RECORD/TAG SORT) 
BLANK CARD 


bm CODE 
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gx co — 


a, 





CARD DECK G 













CARD DECK F 






CARD DECK E 











CARD DECK D OPTIONAL 

(ONLY REQUIRED 
IF OWN CODE 
MODULES ARE 
TO BE RELOCAT- 


ED) 















ss 
PHASE 


USER 


CARD DECK C SUPPLIED 


BLANK CARD 
STATEMENT CARD 


ao ENT CARD 







CARD DECK B 


CARD DECK A 
ne SELF LOADING 


Figure 7—1. Record or Tag Sort, Statement and Own Code Decks 
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BLANK CARD 


BLANK CARD 


PHASE 4 (MERGE) 





CARD DECK H 





BLANK CARD 


OWN CODE MODULE ; 
OWN CODE MODULE 















CARD DECK D 


OPTIONAL 






USER 
SUPPLIED 


fL 


CARD DECKC }=——————]} RELOCATOR PHASE 
BLANK CARD 
STATEMENT CARD 
CARD DECK B 


STATEMENT CARD 


— 41 ponmg it Tore 


Figure 1-2. Merge, Statement and Own Code Decks 










CARD DECK A 


RESTART FEATURE 


The record and tag sort programs can be interrupted anytime after the conclusion of 
the Input/Internal Sort Phase and subsequently restarted. The Sort program determines 
the restart point. A record on the first work disc is created by the Sort program and 
then updated each time a checkpoint is passed. Checkpoints occur at the end of any 
phase and after a pass within a phase. 


Restart is effected by mounting the discs where they were when the Sort was inter- 
rupted and assigning them the same logical unit numbers. The original statement 
deck is resubmitted to the Sort with an additional statement card, RSTRT. 


MULTICYCLE SORT FEATURE 


During an input phase, the Sort determines if one-half of the available work area is 
used before the end of file is detected. If this is the case, the Sort automatically 
terminates the input phase but continues the Sort operation, using only those records 
that were accepted prior to the termination of the input phase. (The Sort records 
information required for the next cycle on the disc checkpoint sectors.) The Sort can 
then be completed in multicycle operation by resubmitting the deck with a MCYCL 


‘statement in the statement deck. 


At least three disc units are required for the merge operation following a multicycle 
sort if the Merge controls the output. If own code controls the output, two disc units 
are required. 
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1.8. LINKING PROCEDURES 





cee” 


When the sort/merge program is to be executed under the control of the Nonconcurrent 
Operating System (NCOS) or higher level operating system, each phase of the program 
must be linked from the library file using the tape linker. The cards needed to accomplish 


this are illustrated by Figure i-3. 


CONTINUED 












PHASE 
PHASETHT,mmmm 






INCLUDE /TBRD 


“PHASE 
PHASETWT,mmmm 
















PHASE 
PHASEFOR,mmmm 





PHASE 


INCLUDE /PHT3 PHASEONT,mmmm 












PHASE 
PHASETHR,mmmm 


PHASETWO,mmmm 


PHASEONE,mmmm 


PHASELNK,mmmm 


INCLUDE /PHSO,xx 


PRGM SORT,mmm NOTES: 


/ EXEC TLOO 


Figure 1-3. NCOS Disc Linker Input 





mmmm = starting address 


xx = logical unit number 
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j To execute the sort or merge operation after the linking, place the disc pack 
containing the newly constructed file on logical unit zero. Place any other discs 
required by the program on their respective units and load the supervisor. Execu- 
tion can then be accomplished by using the job stream illustrated in Figure 1-4. 

USED WHEN INCLUDING 


! OWN-CODE MODULES 
END CARD IN CONTROL STREAM 





Yi ie = 


OWN-CODE MODULE ‘ 


/ 
é 
| 


OWN-CODE MODULE 


ae 
=) 


\ STATEMENT 
CARDS 


Figure 1~4, Loading Program From Dise Under NCOS 
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2. STATEMENT CARDS 


2.1. GENERAL 


The statement names and their associated functions are: 





STATEMENT 

NAME FUNCTION 
DISCS Describes the available work discs. 
IN Describes an input file. 
ILB Specifies input file label information. 
OUT Describes an output file. 

7 OLB Specifies output file label information. 

\ FIELD Describes key fields. 

ae RSTRT Indicates restart of a sort. 
MCYCL Indicates the Sort continues using multicycle operation. 
SORT Describes the characteristics of the Sort operation. 
OWNCD Specifies the own code routines included in the Sort operation. 
END Indicates the end of the statement deck. 


The statement name is specified in the operation field. The label field is blank. A 
statement can contain parameters in the operand field. The first character of the first 
parameter must start in column 16. A comma must be specified for an omitted 
parameter; trailing commas can be omitted. 


The following rules apply in creating a statement deck: 


@ Statement cards can be in any order except for END, which must be the last state- 
ment in the statement deck. 


u Parameters associated with a given statement must be specified in the sequence 
shown in the format description. 


a Commas must separate parameters; a parameter can be omitted; however, the comma 
must be specified. 


w A blank following a parameter indicates the end of the parameter list in that card. 


w Each parameter must conform to the length requirements specified in a given format 
} description. 
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2.2. DISCS 


Use: Indicates the number of work discs available for a sort operation and the 
logical disc unit addresses, 


Format: DISCS Wy, Wo, W3, W4, Ws, We, W7, We. 


Legend: Each w is a unique two-digit logical unit number of a work disc. 
A logical number can be in the range 00 through 07. 


Rules: The-position of a logical number in a statement indicates the sequence in 
which the work discs are accepted for use by the Sort program. 


The value of the logical number assigned to a disc drive must not exceed 
the number of available disc drives. 


A Sort operation requires at least one work disc for each input disc; how- 
ever, a faster Sort is executed if at least two work discs are available. 


A merge operation does not require a work disc unless an own code option 
is used. The work disc in this case need only be online during the initiali- 
zation of the merge; it can then be replaced with an input disc if desired. 


Notes: The logical unit number of a work disc can be the same as that specified 
for an input disc (see 2.3) if an input disc is to be used as an additional 
work disc at the conclusion of the Input/Internal Sort Phase. 


For a record sort operation, the programmer can specify the same logical 
number to both work discs‘and input discs. The Sort will halt at the end 

of the input phase allowing the operator to remove an input disc and replace 
it with a work disc. 


For a tag sort operation, the input, output, and work disc units must be on- 
line for the entire Sort operation when specifying an entire record as output; 
discs for output can be omitted if the output device is provided for by the 
own code routine which can specify any I/O device. 


The maximum number of records that can be sorted can be determined from the fol- 
lowing formulas: 


MAXIMUM NUMBER OF RECORDS 
OPERATION 
NO OWN CODE PRESENT OWN CODE PRESENT 


Record Sort peri) |, ete — 
(Fixed-Length Record) 


Record Sort See) Sonn?) 
(Variable-Length Record) aI REMAX 
Tag Sort as fren | ss [385 | 
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where: D = number of work discs available to Sort program. 
RL = record length. 
RLwax = maximum record length (variable-length records). 
KL = total length of all key fields 
[ ] = round integer to next higher value if quotient contains a decimal 
fraction. 
L J = truncate decimal fraction of quotient. 


Each work disc must have been prepared by the VTOC Recorder. A single file, with 
file identification of SORTWORK and one extent from TT=00, SS=55 to TT =99, 
SS=99 should be created by the user; the Sort rejects any work disc volume not 
meeting these requirements. 


An example of DISC statements selecting work discs on logical units 01 and 03 is: 


SABEL OPERATION eek 





eS sed 
IN 
Use: Describes the characteristics of an input file. 


Format: IN b,ij,i7,¢6fs,8 yn 


Legend: b is a two-digit value indicating the number of records per block. 
The value must be in the range 01 through 99. 


ij is the first logical disc unit number of the input file; the number must 
consist of two digits in the range 00 through 07. 


_ig is the second logical disc unit number of the input file; the number must 
consist of two digits in the range 00 through 07. 


e can be any one of the following: 
C—cance! sort upon detecting a read error. 
D—ignore read error. 

S —skip sector containing read error. 


| 


is the record lengthin bytes for fixed-length records. The record length 
must consist of three digits in the range 001 through 160. This parameter 
must be present when processing fixed-length records. 


s. is athree-digit value specifying the minimum number of bytes contained 
in a variable-length record. The value must be in the range 005 through 
160. 


is a three-digit value specifying the maximum number of bytes contained 
in a variabletength record. The value must be in the range 005 through 
160. 


Joc 
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is atwo-digit value specifying the number of input volumes. The value 
must be in the range O01 through 99, 


n is an eight-byte input file name. It consists of eight alphanumeric 
characters. 


Block size must be in the range 2 through 160 bytes; block size is equal to 
the number of records per block (b) multiplied by the record length (f). 


For variable-length records, the parameters s and g must always be speci- 
fied even if the own code routine controls the input. 


The parameter v does not have to be specified if input is controlled by own 
code. 


If iy and iy are omitted, the Sort program assumes that the input is handled 
by the own code routine. Otherwise, both_iz and i9 must be specified. If 
iy=ig, the input file or files are processed by the same disc drive assigned 
to the logical number specified. 


If a multivolume file is specified, a program halt occurs upon detection of 
an end of volume condition; the next volume can then be mounted. 


If i, 4 ig, the Sort automatically swaps disc drives upon detecting an end 

of volume condition. However, if the programmer specifies two logical units 

for a multivolume input file, the Sort halts upon detection of an end of ) 
volume condition to alert the operator that an automatic swap is to be per- . 
formed, When START is pressed, the swap is executed and the file label 

of the next volume is checked. A display occurs if the label check fails. At 

this point there are several courses of action which are described under the 

ILB (see 2.4) statement in the parameter specification section. 


An IN statement must be present for every input file specified. For a Sort 
operation, one IN statement can be specified; for a merge operation, the 
number of IN statements depends on the number of input disc drives avail- 
able (not to exceed eight). 


If the e parameter is either D or S, the Sort halts on a read error to allow 
the operator the option of cancelling the Sort operation. 


If the_e parameter is omitted, an own code routine must be included to 
handle the error conditions. 
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Use: 


Format: 
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Describes the input file label. 


Hee ee 


Legend: f is the file identification which must be identical to the file name 


Rules: 


Notes: 


2.5. OUT 


Use: 


Format: 


Legend: 


Rules: 


specified in the corresponding IN statement. 


c¢ isthe file creation date which must consist of six characters. The 
leading character may be blank. 
g is the four-character file generation number, - 
“v. is a two-digit value that is one less than the number of the first volume of 


the file. 


The label check must be performed by own code when own code controls 
the input operation; an ILB statement is not required if own code handles 
the input procedure. 


The Sort performs a comparison between the creation date, generation 
number, and volume number in the label and the corresponding information 
in the ILB statement. If any of the values do not correspond, the program 
halts and a display occurs, The operator has the option of either mounting 
a new volume and reinitiating a label check, or continuing the Sort using 
the volume that does not check. In this case, the values specified in the 
ILB statement are replaced in the Sort by the values in the label; these 
values are then used to check subsequent volumes in a multivolume file. 


Describes the characteristics of the output file. 
OUT b, 21, 22 


bis a two-digit value indicating the number of records per block. The 
value must be in the range 01 through 99 bytes. (Block size must be in 
the range 2 through 160 bytes; block size is equal to records per block 
multiplied by the record length.) 

01 is atwo-digit value specifying the first output file to be written. 

22 is atwo-digit value specifying the second output file to be written. 


An OUT statement must appear in the statement deck unless own code is 
to control the output operation. 


For a merge the parameters 9; and 99 must be specified unless own code is 
to control the output operation. 


Both o; and_oy parameters must be specified or both omitted. If_o] = 09 
both output volumes are processed using the same disc drive. If_o1 4.99 
the Sort program performs an automatic disc swap upon detecting an end of 
volume condition. 


If both.g; and_g9 are omitted, the Sort program determines the logical unit 
to be used for output. A program halt is executed and a display notifies the 
operator of the logical output unit selected. 


PAGE: 
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Use: 


Format: 


Legend: 


Notes: 


FIELD 
Use: 
Format: 


Legend: 


Rules: 
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For a record sort or a tag sort the parameters 91; and oo must not be the 
same as a logical unit specified for a work disc. For a tag sort, the values 


‘specified for parameters 9; and_go must not be the same as that ‘specified 
for a work or an input disc, 


Describes the file label to be created for output discs. 


f isa file identifier comsisting of eight alphanumeric characters. 

c¢ is the creation date consisting of ‘six characters. 

g is the four-character file generation number. 

Vv is a two-digit value that is one less than the number of the first volume 
of the file. 

is the six-character expiration date. 


|» 


The Sort creates the labels unless own code controls the output operations; 
own code must then create output labels. 


Describes a maximum of 12 key fields. 


FIELD fspn, fspn, fspn, fspn, fspn, ... fspn 


Each fspn describes one key field in a record; a maximum of 12 key fields 
may be specified. (The first field is called a major key field; the sub- 
sequent fields are called minor key fields.) The characters fspn represent 
the following: 


£ indicates the following formats: 
C indicates a character field; maximum field length is 160 bytes. 
B indicates a signed binary field; maximum field length is 160 bytes. 
D indicates a packed decimal field; maximum field length is 16 bytes. 
Z indicates a zoned decimal! field; maximum field length is 16 bytes. 
s indicates the required order of the following sorted output: 
A indicates an ascending sequence. 
D indicates a descending sequence. 
p indicates the position in a record of the most significant byte of the key 
~~ field; _p must be a three-digit number in the range 001 through 160. 
mis indicates the number of bytes in the field; n must be a three-digit 
number in the range 001 through 160. 


If own code performs the record sequencing operations, a FIELD statement 
must not appear in the statement deck. 


At least one FIELD statement must appear in a statement deck; a maximum 


of 12 fspn specifications can be made. 
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} The fields are entered on the FIELD statement card in order of their signi- 
ficance, that is, the leftmost field is the most significant field in a state- 
ment, or, if more than one card is used, the first card contains the most 
significant field information. 


For variable-length records, the number of bytes in a key field must not ex- 
ceed the minimum record length specified in the s parameter of the IN 
statement (see 2.3), 


For atag sort, the total key length in bytes must be in the range 1 through 
153. 


2.8. RSTRT 


Use: Specifies restart points that are to be established during the execution of 
a Sort operation. 


Format: RSTRT 


Notes: The RSTRT statement does not contain parameters. 


The RSTRT statement is required by the Sort operation if a restart is to be 
executed. 


Checkpoints occur at the end of any phase and at the end of any pass with- 
in the phase. 


The Sort may be interrupted at any time after completion of the Input/Internal 
Sort Phase (Phase 1). Subsequent restart is effected by mounting the discs 
where they were when the Sort was interrupted and assigning them the same. 
logical unit numbers. The original statement deck is resubmitted to the Sort 
with an additional statement card (RSTRT). 


2.9. MCYCL 


Use: Indicates that the Sort operation is to continue in the multicycle mode if 
the work area becomes inadequate for sorting in the normal mode. 


Format: MCYCL 


Rules: If the Sort determines the logical number of the disc drive for output (oy 
and Qo in the OUT statement are omitted), a program halt and a display 
occur. The operator must then place a work disc on the drive associated 
with the logical unit number. 


Notes: The MCYCL statement does not contain parameters, 
A halt display notifies the operator that a multicycle operation is required. 
To restart the Sort process, the programmer must reload the Sort program, 


supply ali the original statement cards and include a MCYCL ‘statement 
) card. 
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2.10. SORT 


Use: 
Format: 


Legend: 


Rule: 





Indicates the required characteristics of the Sort. 


SCR ha eee 
_n specifies the highest memory address available to the Sort. The address 
must be equal to or less than that ‘specified in the boundary table of 
the Minimum Operating System. If the value is omitted, the Sort uses 
the value in the boundary table. 
t specifies the type of sort operation: 


T= tag sort 
R= record sort 
M= merge 


d specifies a data reduction procedure (if this parameter is omitted, own 
code must be supplied): 
R indicates that the Sort is to retain records with equal key fields. 
D indicates the Sort is to delete one of two records with equal key 
fields. 
f specifies the form of the final output for a tag sort: 
A= disc addresses only 
K= disc addresses and associated key field 
R= entire record 
specifies the number of bytes of memory to be reserved by the Sort pro- 
gram as common to an own code input and own code output procedure. 
The number of bytes must be expressed by three digits in the range 001 
through 160. (The first byte of this area can be addressed by specifying 
the label associated with a RES instruction. ) 
w indicates whether a write check operation is to be performed: 
0 does not perform a write check 
1 write check to be performed during output of final sequenced file 
2 write check to be performed during all phases of a record or a tag 
‘sort 


Jo 


When data reduction own code is used, the d parameter must be omitted. 
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2.11. OWNCD 
Use: Specifies the type of own code routines provided by the programmer. 
(The use and requirements of own code routines are described in Section 
3.) 


Format: OWNCD a, b, c,d, e, f, g 

is 1 if input procedure own code is included; omit if input own code is 

not included. 

is 1 if analyzation own code is included; omit if-own code is not 

included. 

is 1 if read error own code is included; omit if own code is not included. 

is 1 if record sequence own code is included; omit if own code is not 

included. 

ts 1 if data reduction own code is included; omit if own code is not 

included. 

is 1 if output analyzation own code is included; omit if own code is 

not included. 

g is 1 if output procedure own code is included; omit if own code is not 
included. 


Legend: 


|» 


I> 


|o |a.Jo 


|-. 


Notes: Own code exits are provided for input, merge, and output functions of the 
Sort program. 


' The OWNCD statement must include commas for the parameters that are 
: omitted. For example: 


OWNCD ,,,1,,,1 


indicates that only record sequence own code and output procedure own 
code are included in the Sort program. 


2.12. END 
Use: Indicates the end of the statement deck. 


Format: END 
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2.13. EXAMPLE OF SORT STATEMENT DECK 
The following example illustrates the statement cards required to sort a file. (Own 
code options are not used. No data reduction or write check is performed.) 
LABEL 6 OPERATIONS OPERAND $ COMMENTS : 
1 10 16 72 80 


0 8 8 La ba 





FA er nd GTO PO 



































1350 0 Nye iV ye St, 915,016 0,2 YM STR PY RL} 
ae aL ea MP ll Ve AN en OS tO ks) Ue ae a a 
pod ee 
period riri i daria tirriirtirritiriit 
STR PYRO) 2,2,7,6 8), 0,0,0,1,,9,% fi a | 
errr tay rr torrie teri ir tire i tai iil 
GC 
paotdrrritianepit irr diirrtrtirriit 
pope toa eden te bi bari | 








MS TREY, RL, he 1?,2,8,6 8) 9,0,02), oo, 913,28 6,8) 





C,A0 0,210 ,0,5,, CyA,0,0,9,030 2 


dariitiiiirt 


Po a 





R,,R 


preaoterirar ti rir tire De ig baa te 





posoatiarrartiriririt resi tay si ta iad 





Jott 1 it Jt ad bs Oe ea Loa asada Se es ay aL 


ri (jee enero Ee Boel gf aC Cs Un coer Om 





priatoeriiatiis 





ps es el ee ad a CRs a Co 


Thtee work discs are availabie. 
(03) records per block, (01,01) the first and second input discs are assigned 


to logical drive 01, (S) skip sector containing read error, (050) number of 
characters pet record, (02) number of input volumes, (MSTRPYRL) file 1D. 


(MSTRPYRL) file ID, (022768) creation date, (0001) generation number, (00) 
volume number, 


Three records pet output block (blocked output records). 
({MSTRPYRL) file 1D, (022868) creation date, (0002) generation number, (00) 
volume numbers, (032868) expiration date. 


First field: (C) character field, (A) sort on ascending key sequence, (002) 
position of most significant byte, (005) number of bytes in fieid. 


Second field: (C) character field, (A) sort on ascending key sequence, (009) 
position of most significant byte, (002) number of bytes in field. 


(R) record sort, (R) retain records with equa! key fields. 


End of statement deck. 
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) 3. OWN CODE ROUTINES 


3.1. GENERAL 


Own code options available to the programmer and the requirements for linking these 
routines with the Sort programs are explained in this ‘section. 


The first instruction of an own code routine must specify a label provided by the 
Sort package. The label names and the own code functions associated with each 
label are a's follows: 


RSOC — Record Sequencing 

DROC — Data Reduction 

IPRO — Input Procedure 

ERRO — Input Error Handling 

ALYI — Analysis of Input Record 
OPRO — Output Procedure 

ALYO — Analysis of Output Record 


The following rules must be considered when using own code routines: 


m Own code routines must contain ENTRY statements for names referenced in own 
code by the Sort program. 


ae 


m Own code must include EXTRN statements for names referenced by own code 
that are contained in the Sort program. 


w Register 14 must not be used by own code. The address of the next sequential 
instruction in the Sort is stored in register 14 (by a BAL). Register 14 is the 
means by which own code returns program control to the Sort (by a BC). 


m Own code routines can be supplied to the Sort or merge program's on cards in re- 
locatable format. If own code is assembled using the tape or the disc assembler, 
only one CSECT can be specified and no COMMON can be specified. 


3.2. IPRO 


Use: Allows input devices other than disc to be used in a‘sort operation. 
Operation: After reading a record into storage, own code transfers an input record 
to the work area defined by the Sort program then transfers control to 


the address of the next instruction stored in register 14. The label of 
the work area is WORK. 


Rules: Own code must perform label checking procedures. 


After processing the entire file, own code must transfer control to the 
instruction labeled EOI in the Sort program. 


) ALYI (see 3.3) of ERRO (see 3.4) own code must not be used when IPRO 
is used. 
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3.3. ALYI 


Use: For own code analysis of each input record to determine whether the 
Sort is to retain or delete the record. 


Operation: The Sort program reads a record and transfers control to the label ALYI 
in own code. Register 11 contains the address of first byte of the record. 
If the record is to. be retained, own code transfers control to the Sort 
program at the address in register 14. If the record is to be deleted from 
the file, own code transfers control to the label DLET in the Sort 
program, 


Rules: AL YI is used only if the Sort program controls the file input procedure 
IPRO (see 3.2) cannot be present. 


3.4. ERRO 


Use: For own code determination of whether a record that generated a read 
error is to be accepted or rejected by the Sort or merge programs. 


Operation: If a read error is detected, the Sort and merge programs transfer control 
to the label ERRO in own code. 


Rules: Register 11 contains the address of the first byte of the data containing 
an error. 


If the data is to be processed, own code transfers control to the Sort or 
the merge program at the address in register 14; if the data is to be by- 
passed, own code transfers control to the instruction labeled RJCT in 
the Sort or the merge program. 


ERRO must not be used if IPRO is used. 


3.5. RSOC 


Use: To sequence records using own code, 


Operation: After records are read, the address of the first byte of one record is 
placed in register 11 and the address of the first byte of the other 
record is placed in register 12. Control is then transferred from the Sort 
program or the merge program to the RSOC routine where the key fields 
in the records are compared, Using the address in register 14, the RSOC 
routine then returns control to the Sort program or the merge program 
where the condition code is examined to determine which of the two 
records is to be written. 


When the value of the condition code indicates that operand 1 of a com- 
pare or a test instruction is less than operand 2 of that instruction, the 
record referenced by register 11 is selected by the Sort program or the 
metge program. When the value of the condition code indicates that 
operand 2 is less than operand 1, the record referenced by register 12 is 
‘selected. (If the value of the condition code indicates that the key fields 
compared are of equal value, a record is selected arbitrarily.) 
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j To create a file based on an ascending order of key fields, the programmer 
must use operand 1 of a compare instruction to reference the key field of 
the record associated with register 11. Conversely, a descending order 
of record key fields is created by using operand 1 to reference the key 
field of the record associated with register 12. 


Rules: Own code operations must not alter either the records or the contents of 
registers 11 and 12. 


3.6. DROC 


Use: For data reduction by combining information in two or more records con- 
taining equal key fields. 


Operation: The Sort program enters the own code at the label DROC to permit data 
reduction when either of the following conditions exist: 


m the records contain key fields that are equal, or 


m the condition code indicates an equal state upon returning from the 
RSOC (see 3.5) own code. 


When a data reduction procedure is to be performed, the Sort transfers 

control to own code label DROC; register 12 contains the address of the 

first byte of the record that can be eliminated and register 11 contains 
‘ the address of the first byte of the other record. 


Rules: After the data in two records have been combined, own code transfers 
control to the label DELE in the Sort program; the Sort program eliminates 
the record pointed to by register 12. 


When data reduction is not required, own code transfers control to the 
address in register 14 which returns program control to the Sort program. 


Own code must not change the contents of the key fields of a record to be 
retained. 





Own code must not change the contents of registers 11 and 12. 


The d parameter in the SORT statement (see 2.10) must be omitted if the 
data reduction own code is included in the Sort program. 


3.7. ALYO 


Use: For analysis of a record prior to transfer to an output file. 


Operation: Before writing a record, the Sort and merge programs enter own code at 
the label ALYO and load register 12 with the address of the first byte 
of the record. Own code determines whether the record will be written in 
the output file or will be deleted. 


) Rules: If a record is to be retained, own code transfers control to the Sort or the 
merge program at the address in register 14. 
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If the record is to be deleted, own code transfers control to the instruc- ; 
tion label DROP in the Sort or the merge program. 


If ALYO own code is included in the program, the Sort or merge program 
must control the output operation. 


3.8. OPRO 


Use: For controlling the output of the final sorted file. 


Operation: Before a record is written in an output file, the Sort and merge programs 
load the address of the first byte of the record into register 11 and trans- 
fer control to the label OPRO in own code. To request another record, 
own code transfers control to the Sort or the merge program at the address 
in register 14, 


Upon detecting an end of file condition, the Sort or merge program trans- 
fers control to the label EOFO in own code. After completing end of file 
procedures, own code transfers control to the Sort or merge programs at 
the address in register 14. 


The Sort program provides a record count for use by own code. The label 
of the count field is RCNT and consists of a four-byte packed decimal 
field. 


3.9. SUMMARY OF OWN CODE OPTIONS AND LINKAGES —_ ) 


Table 3—1 shows the own code functions that are allowed in the Sort and merge opera- 
tions and indicates the positional parameters specified in the OWNCD statement 
(see 2.11). 


POSITIONAL OWN CODE PERMITTED FOR: 
PARAMETER 
IN OWNCD 
OWN CODE OPTION STATEMENT 


Input procedure 
Analyze input record 





Table 3-1. Own Code Options 
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Table 3—2 shows the allowable EXTRN cards in each own code routine. The X in- 
dicates allowable usage. 


OWN CODE ROUTINES 


EXTRN 
NAMES DESCRIPTION RSOC |DROC | pRo|eRRo| ALYI |OPRO |ALYO 


Input file ID (8 bytes) el xX P| yee 
Input file creation date (6 bytes) = 
Input file generation number (4 bytes) as 
Input file volume number (2 bytes) aa 
Output file ID (8 bytes) Ls 
Output file creation date (6 bytes) fad 
Output file generation date (4 bytes) a 


OLBV | Output file volume number (2 bytes) 
OLBX | Output file expiration date (6 bytes) 
WORK | Sort work area (up to 160 bytes) 


h End of input when own code controls 
‘ input 
DLET | Delete logical record 


X 


X 


x 


| 


be 


ee 


DELE Record deletion for data reduction | | xX 


RES Base of common area for input and 
: output own code procedures (up to 
160 bytes) 
DROP Deletion of logical record in final 
output phase 


Record count (4 bytes) 


RJCT Delete physical record peal 





Table 3~2. EXTRN Names 


Table 3-3 shows the allowable ENTRY cards in each own code routine. The X in- 
dicates allowable usage. 
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Table 3-3. ENTRY Nomes 


3.10. DISC RESIDENT OWN CODE 


If own code modules are to be loaded from a disc library then control cards are re- 
quired which will direct the Relocator Phase of the Sort or merge to extract and re- 
locate the own code modules for subsequent execution. There are two control card 
formats, primary and secondary. 


The primary control card must appear first in the control card deck and signals to 
the Relocator Phase that own code modules reside in a disc library. The following 
chart illustrates the format of the primary control card. 


PRIMARY CONTROL CARD 


CARD COLUMNS DEFINITION DESCRIPTION ? 
10-14 Control indicator EBCDIC. Must contain DSKOC. 


File name EBCDIC. Eight alphanumeric characters uni- 
quely identifying the disc library 
file. !f these columns are blank then 
the name assumed is SYSFILE. 


Logical unit EBCDIC. Two-digit number (00-63) indicating 
number the logical unit number of the file 
containing disc library. 





The logical unit number of the disc on which the disc library resides must not be 
the same as any work disc specified on the DISCS statement card. 
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) Each secondary control card defines one own code module. The secondary control 
cards must be read in the same order as that required for own code modules, which 
is: RSOC, DROC, IPRO, ERRO, ALYI, OPRO, and ALYO. Each’secondary control 
card must contain the module name of the desired own code module. Group name 
specification is optional. If only the module name is specified, the Relocator 
Phase of the Sort or merge will search the disc library directory from the beginning 
for a match on the module name. On a match condition the module will be extracted 
and relocated. A no-match condition results in an error display. When both group 
name and module name are specified, the disc library directory is first searched 
for a match on group name. On a match condition the search continues until there 
is a match on module name or an End of Group (EOG) demarcation record is 
encountered. Own code modules should not reside in nested groups. 


The following chart illustrates the format of the secondary control cards, 













SECONDARY CONTROL CARD 


CARD COLUMNS DEFINITION DESCRIPTION 


_ 
7 


The primary and secondary control cards must be followed by an END card with /* 
in Columns 1 and 2 and END in Columns 10-12. 





EBCDIC. Eight alphanumeric characters uni- 
quely defining the group in which 
the own code module will be found. 






EBCDIC. Eight alphanumeric characters 
uniquely defining the module name 
of the own code module to be ex- 
tracted and relocated. 





All own code modules which are to be loaded from a disc library must be in re- 
locatable format. If any other format is encountered during execution of the Re- 
locator Phase, the Sort or merge will be cancelled following notification of the 
error condition. 
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4. TIMING CONSIDERATIONS 


4.1. GENERAL 


This section contains timing formulas which may be used to estimate sorting times 
for files contained on 8410 DAS Disc Units. 


4.2, RECORD SORT 


To estimate sorting time for a record sort, it is first necessary to calculate how many 
records will be sorted internally during Phase 1. The number of records sorted 
internally (RSI) allows calculation of the number of strings (S) produced by Phase 1, 
which in turn can be used to determine the number of merge passes (P) required by 
the Sort. 


To determine RSI and S the following calculations should be performed. 


MS-8K-OC = TSC 
160 
> filo 


(3) IfST>4, SET ST =4 Ee | = SST 


(4) Then: RSI = ST x SST x SB 


where: SB equals sort blocking. Sort blocking is determined in the following 


mannet: 
or 160 
RL inax 
where: = record length (bytes) 





ra = maximum record length in variable-length input file. 


) (5) And: S = ] 
RSI 
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= Available memory (number of bytes) 


= Number of sectors per internal substring 


Number of strings produced by internal sort 
Total number of records to be sorted 


Round integer to next higher value if quotient contains a decimal 


where: MS 
K = 1000 
OC = Number of bytes used by own code 
TSC = Total working sectors 
ST = Number of internal substrings 
SST 
S = 
N = 
RSI = Number of records sorted internally 
[] = 
fraction 
ik 2 


Truncate decimal fraction of quotient. 


Then it is necessary to determine the order of the merge (M). This is done in the 


following mannet: 


If MS is in the range L2K<MS<16K then M = 5. 
If MS is in the range L6K<MS<20K then M = 6. 
If MS is > 20K then M = 8. 


Having determined S and M, P can be obtained by referring to the following charts: 


Chart 1 






Having determined M, P, and S, sort time for each of the three phases of the Sort can 


15626-78125 


Passes (P) 


Strings (S) 


Chart 2 


Chart 3 














Strings (S) 











1-5 1-6 1-8 
6-25 7-36 9-64 
26-125 37-216 65-512 
126-625 217-1296 513-4096 
626-3125 - 1297-7776 4097-32768 
3126-15625 7777-46656 32769—262144 


now be estimated using the formulas given below. 


Phase 1 (T1) 


T1 = fn ]ss. + x] 47 + |n |] 25 +. sl{stxsstx5]50 
BI BI SB 100 
T00 
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in milliseconds. 


Phase 2 (T2) 


12°: =i) apse 27.5 + 
SB 


2 ae 235 in milliseconds, 
SB 


100 


ee 
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[ss] * 


in milliseconds. 


* Fal] 


100 


Ed 


100 


fas] 


where: BI = Input blocking, that is, number of records contained in one sector. 
BO = Output blocking. 
Therefore, total record sort time (TT) becomes: 


TT in minutes. 


= Tl + T2 + T3 
60000 


4.2.1. Record Sort Timing Example 

Assume a file with the following characteristics is to be sorted: 
m Bytes inthe record (RL) = 
m Available memory (MS) = 16,000 bytes 
m Input blocking (BI) = 1 


m Output blocking (BO) =2 






i m Number of records to be sorted (N) = 5,000 
Then: 
TSC = 16000 - 8000 = 50 
160 
= faye 
SST = | 50 = 25 
2 
= tole 
RSI = 2x25 x2 j= = 100 
S = = 50 








S900] 
200] 
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Since MS equals 16000, M = 6; therefore, ) cai 3 is obtained from Chart 2. ) 
Then: Tl = (5000)55 + 47 + (2500)25 + 50) 2x25x5_ 58 = 348550 
au “100 — 
T2 = 2(2500)27.5+2 235 298500 
—_ 
T3 = (2500)30 +[2500 | 235 - + (2500960 +00. a 47 = 207150 
00 100 
and total sort time becomes: 
348550 + 298500 + 207150 14 o-mauted 
. 60000 ‘ 
4.3. TAG SORT 
To estimate sorting time for a tag sort the formulas given under record sort apply 
with the following exceptions: 
SB should be determined by 
a raed 
where: KL = total length of all key fields to be compared. . 


If the sorted output consists of disc address only, or disc address plus key informa- 
tion only, then T3 is calculated in the same fashion as described under record sort. 

However, if the entire record is to be written, use the following formula to calculate: 
T3 time: 


[n__]30 3 235 50 47 + AS(N) 
a 
Hs [ 
where: AS = “ia 
BI 


100 


NOTE: If AS > 147, set AS = 147. 


ae” 
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) 4.3.1. Tag Sort Timing Example 1 


When necessary to determine sorting time for a file which has the following charac- 
teristics: 


m= Bytes in the record (RL) = 80 
m Available memory (MS) = 16,000 bytes 


w Input blocking (BI) = 1 


m Output blocking (BO) = 2, and the entire record is to be written: 
wu Number of records to be sorted (N) = 5,000 


w Total length of all key fields (KL) = 3 bytes 


Then: TSC = 16000 - S000 | = 50 
160 
Sst = |50 
2 
: SB = |160] = 16 
i 10 


RSI = 2x25 x 16 = 800 


5000 
~ 800 


Since MS equals 16000, M_= 6 6, and P=2 2 is obtained from Chart 2. 


So: Tl = (5000) 55 + 47 ata 25 + [2s 25 x 2x25x5| 58 = 286393 
on 100 
T2 = 1 | 2(313)27.5 + 2 “Te 3| 235 ie 19070 


T3 =  (313)30 235 + (2500)50 + [2500 47 +97(5000) = 621483 
io 100 


Ul 
hd 


25 


and total sort time becomes: 
286393 + 19070 + 621483 s 


ea000 15.5 minutes: 
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4.3.2. Tag Sort Timing Example 2 ) 


If the file described in the preceding example is to be sorted, but instead of the 
entire record, only the disc addresses are required as final output, and they are 
to be blocked twenty-two (22) per sector, the values computed in the previous ex- 
ample apply and 


Tl = (5000)55 47 + a 25 + 7)2x25 x5 | 58 = 286393 
a 000° 


T2 = Fo #22 333] e = 19070 
T3 = 313(30) * fs a 235 + [so00] 50 + [228 8 |47= =21871 


So total sort time becomes: 


286393 + 19070 + 21871 


60000 = 5.5 minutes 


4.4. DISC WRITE CHECK OPERATIONS 


Whenever the disc write check operation is requested, sort times are increased 
considerably. The formulas below should be used in estimating ‘sort times if the ) 
write check operation has been specified for any phase. 


Phase 1 (Record or Tag Sort) 
N{.s5 + [TN 75 +S [ stxassrxs] 58 
BI BI 100 
‘100 


in milliseconds. 


Phase 2 (Record or Tag Sort) 


(P-1) 2] N]52.5 + 2 in milliseconds. 
SB 
se 


Phase 3 (Record Sort, Tag Sort w/ disc address or tag output) 


fel “(ea = fel“ )° 


100 100 


HW 


T2 


N 


T3 


in milliseconds. 
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Phase 3 (Tag Sort with Record Output) 
30 + ea 100 + a 47 + AS(N) 
BO BO 
Ea 100 
in milliseconds 


Table 4-1 shows the differences in sort times for the three preceding examples when 
a write check operation has been specified. 















WRITE CHECK WRITE CHECK 
NO WRITE CHECK OUT PUT PHASE ONLY ALL PHASES 
(MINUTES) (MINUTES) (MINUTES) 


RECORD SORT 
EXAMPLE 
TAG SORT 
EXAMPLE 1 
TAG SORT 
EXAMPLE 2 


Table 4—1. Sort Timings 















The time involved in mounting or dismounting discs is not reflected in the foregoing 
discussion of ‘sort timing considerations, 


Nee 


Timing formulas are based on the assumption that at least two work discs are avail- 
able to the Sort. 


MINIMUM DISC REQUIREMENTS 


NO OWN OWN OWN 
TYPE SORT OWN CODE CODE IN CODE OUT CODE IN & OUT 


: 


Tag- 
Tags 
Address 
Records 





tf An input unit can be designated for output. 
NA=Not applicable or not consistent. 
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Do. HALTS AND DISPLAYS 


5.1. GENERAL 


This section describes the halts and displays which can occur during the execution 
of a Sort or a merge program. 


5.2. HALTS - PHASE O 


To continue control card validation after a display, press the START switch. If a 
control card error has occurred, the Sort is terminated at the completion of the card 
deck validation. 


The Sort can be cancelled after any error eel by keying a nonzero into location 
4 and pressing the START switch. 


HEXIDECIMAL 
DISPLAY REASON ACTION 


Press START to ignore 2nd to 
last card in output hopper, or 
cancel, 


1008 Output block size > 160 bytes, 


1009 Work disc not available for own 
code used with merge program, 


1011 
1012 Improper field length or value on 
a DISCS card. 


1014 A work disc is specified more 
than once, 
1020 





1001 Illegal statement name detected, 
















Cancel. 








Continue validation or cancel. 


No work discs specified in the sort. 















Continue validation or cancel. 












Not all required fields are on 
the IN card, 
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1021 Input block size > 160 bytes. 


1022 Blocking factor on IN card is 
notl<ILB.F. <99, 

1023 

1024 Invalid ‘e’ field on IN card. 


1025 Record length not 0 < R-L-< 160 


or field length # 3 bytes. 
1026 


1027 Invalid ‘‘number of volumes’’ 
field on IN card. 

1028 File ID field length is 7 8 on 
the IN card. 

1029 Too many fields on the IN 
card, 

1030 

1031 

1032 

1033 

1034 

1035 

1036 















Input unit designation on IN 
card is not valid. 



















Variable-length and fixed-length 
were both specified on the IN 
card, or the variable lengths 
were specified incorrectly. 















Continue validation or cancel. 













Not all required fields are on 
the ILB card. 












File ID field length on ILB 
card F 8. 











Creation date field length 
on ILB card F 6. 











Generation number field 
length # 4. 










Starting volume number field 
length on ILB card F 2. 











Too many fields on the ILB 
card. 











Invalid blocking factor field 
on OUT card. 
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SECTION: 






ACTION 





1037 Invalid output disc designation on 
OUT card. 
1038 Too many fields on the OUT card. 


1039 All required fields not on the OUT 
card. 













All required fields not on the 
OLB card. 






File ID field length on OLB 
card # 8, 







Creation date field length on OLB 
card F 6. 







Generation number field length on 
OLB card F 4. 








Output volume number field length 
on OLB card F 2. 











Expiration date field length on 
OLB card 7 6. 


Too many fields specified by 
FIELD cards. 


1053 Too many OUT cards. 
1054 Too many OLB cards. 





Continue validation or cancel. 



















1055 Too many IN cards, or none at all. 


File ID’s on IN and ILB cards 
do not match. 





1056 








Cancel. 
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HALT NUMBER REASON ACTION 


1057 All key fields are not within the 
bounds of the records. Cancel. | 


1060 All required fields are not on the 
SORT card. 

1061 Highest memory byte noted on 
SORT card is not < value in MOS 
boundary table. 

1062 Invalid specification of type of 
sort, 

1063 Highest memory byte field on 
SORT is improper length. 

1064 Data reduction indicator on 
SORT card is invalid. 

1065 Invalid tag sort output field on 
SORT card. Continue validation or cancel. 

1066 Tag sort output indicator is pre- 
sent but a tag sort was not re- 
quested. 

1067 Invalid reserve field on the SORT 
card, 


1068 Invalid write check indicator on 
SORT card. 
~ 1069 Too many fields on SORT card. 
1070 An invalid field is on the OWNCD 
card. 


Too many fields on the OWNCD 
card. 


1072 The SORT or IN card is missing. 


Illegal combination of cards and/or 
own code options when requesting Cancel. 
a merge. 


Input and output disc unit are not 
unique in a merge, 
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HALT NUMBER 







5 


SECTION: 








REASON ACTION 


1075 Too many input discs specified. 


1076 


1077 


1078 
1079 


1080 


1081 


Illegal combination of own code 
and statement cards when doing a 
record sott. Cancel. 


Restart was illegally requested: 
either the input phase was not com- 
pleted previously or the statement 
cards are not exactly the same as 
they were in the initial sort. 


Combination of input and output 
units is > 8. 


No input disc may contain more 


than one input file. Continue validation or cancel. 


No data reduction was specified 
on either the OWNCD card or the 
SORT card, or it was specified 
on both. 


Both the input volume count on the 
IN card and IPRO on the SORT 
card are missing. Cancel. 


Input and work disc numbers may 
not overlap in a tag sort. 


Own code input is not legal in a 
tag sort. 


Input unit numbers and output unit 
number overlays in atag sort with 


record output. 


RSOC and DROC are illegal own 


code routines in a tag sort. The d 
field must be specified on the 
SORT card. 


A DISCS, FIELD, or ILB card is: 
missing. 


The sum of the key field lengths 
is > 153. 
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HALT NUMBER REASON ACTION 


MCYCL was illegally requested. 
Multicycle information is not on the 
checkpoint disc; or, the statement 
cards are not identical to those 
used in the initial sort. 










MCYCL and RSTRT were illegally 
requested in the same run. 









A specified output was also spe- 
cified as a work disc. 


The read error option on the IN 
card and the ERRO own code 

routine were either both specified 
or neither specified. One and only 
one must be specified. 










Press START to cancel. 









When there are no OUT and/or 
OLB cards, the OPRO own code 
routine must be used and ALYO 
is not allowed. 








The number of input discs is 
greater than the number of noninput 
work discs. 







Due to a previous error the phase 
(and thus the sort) is being 
terminated. Fix the statement 
cards and reload Phase 0. 










(1) Press START to check the 
same disc again. 





The disc on logical unit xx 

does not contain a single file 
called SORTWORK, or a read 
error was detected when checking 
the file name. By pressing START 
the disc on unit xx will again be 
checked for the SORT WORK file 
name. 




















(2) Mount a new SORTWORK 
disc and press START. 






(3) Cancel, 











(1) Press START to try read 
again, 


Unable to read the checkpoint 
from logical unit xx when a 
RSTRT or MCYCL was re- 
quested. 
















(2) Cancel. 
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5.3. RELOCATOR PHASE DISPLAYS 


Card read not an A, J, K, H, Q, or 
Y¥: 






3D04 
3D05 


Own code input not in proper se- 
quence, that is, text before ex- 
ternal definitions, etc. 













Amount of own code will not fill 
in allotted area on disc check- 
point. A maximum of 14,601 bytes 
is allowed. 


Disc write error. 


Unrecoverable disc error. 


Own code missing (card loadable 
own code). 






(Disc loadable own code) 





DISPLAY REASON ACTION 
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Press START to read next 
card or ENTER a nonzero 
character into location 4 by 
means of the ALTER, and 
press START to cancel the 
sort. 











Rerun sort. Press START to 
cancel. 











Reduce amount of own code. 
Rerun sort. Press START to 
cancel. 











Press START to display eeuu 
where ee = disc error, uu = 
logical unit number. Press 
START again to retry or enter 
a nonzero character into 
location 4 and press START 
to cancel, 


















Press START to display eeuu. 
Correct malfunction and rerun 
Sort. 









Clear reader and place missing 
own code into reader, feed a 
card and press START, or en- 
ter a nonzero character into 
location 4 and press START 

to cancel. 


















Clear reader and place missing 
secondary control card(s) 

into reader, followed by an 
END card. 
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REASON 


Phase 1 cannot execute due to 
amount of own code present. 


HALT NUMBER ACTION 


3D08 


3D11 


3D14 
3D15 Own code module not re- 
locatable code. 


3D16 
3D17 



























Reduce own code used. Press 
START to cancel. Rerun sort. 


Phase 2 cannot execute due to 
amount of own code present. 









Phase 3 cannot execute due to 
amount of own code present. 













Press START to cancel. Cor- 
rect input to Relocator Phase. 
Rerun sort. 


No A card (element definition 
card) or more than one A card for 
own code module. 














Reduce own code or number 
of input files. Press START 
to cancel. Rerun-sort. 







Merge cannot execute due to 
amount of own code present. 









Correct card input to Re- 
locator Phase. Press START 
to cancel. Rerun sort. 


END card out of sequence (card 
loadable own code). END card 
encountered before transfer card 
of own code module. 

















Own code module contains in- 
valid EXTRN. 











Own code module contains in- 
valid ENTRY. 







Press START to cancel. 
Correct error condition and 
rerun. sort. 








Own code module present that 
was not specified on OWNCD 
statement card, 









An own code module was input 
more than once. 






Own code modules not in proper 
sequence. 









An own code module did not 
have all of the required 
ENTRIES. 











Invalid logical unit number of 
disc unit containing disc 

library file (this unit assigned to 
sort as input or output). 
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DISPLAY REASON ACTION 


Own code module cannot be Jocated 
in group specified on secondary 
control card. 











Press START to read next 
control card or enter a non- 
zero character into location 
4 and press START to | 
cancel. 










Own code Module whose name is 
specified on secondary contro! card 
cannot be located in disc library. 












No module name specified on 
secondary control card. 





Group name specified on secondary 
control card cannot be located in 
disc library. 







Mount new volume and press 
START for new search or 
enter a nonzero character 
into location 4 and press 
START to cancel. 


Disc library file cannot be located 
on logical unit xx. 





















Press START to cancel. 
Correct error condition and 
rerun sort. 


Disc library file on logical unit xx 
is on unit also specified to be a 
SORTWORK unit. 













If START is pressed after 
errors 5, 7, or 8, sort is 
cancelled. If START is 
pressed after errors 1, 2, or 
F, disc operation will be re- 
tried. Enter a nonzero char- 
acter into location 4 and 
press START to cancel. 





Disc error when reading disc library 
file. 






















Unrecoverable abnormal line 
Unrecoverable output bus check 
Catastrophic failure 
Nonoperational channel 
Invalid function 

Unload buffer not successful 











error tape 
logical unit number 


co) 
iT} 


XX 


5.4. INTERNAL SORT PHASE HALTS 


For any error halt, a nonzero keyin into location 4.will result in the execution of the 
cancel macro. 


The x in position 1 of the halts listed below will be a 1 in the record sort program 
and a 2 in the tag sort program. 


nee” 
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HALT NO. REASON ACTION 


x301 | Read error detected on input. Record that an errored 


sector of record is being 


sorted. Press START. 
Read error detected on input. 


























Record that an errored 
sector of records was 
dropped. Press START. 


Read error detected on input. 















Press START to cancel the 
sort. 


Illegal memory allocation on the 
SORT card or in the MOS boundary 
value table, 














The file to be sorted is an indexed 
sequential file. This is an illegal 
file type. , 








Press START to sort the 
file. 


The file type is other than sequential 
or indexed sequential. 












or 
Insert a nonzero keyin to 
cancel. 








Press START to retry the 
read, 





Read error detected when reading 
own code information from the 
checkpoint. 

See Note 1. 














or 







Cancel. 










Cancel. Then, change either 
the parameter on the SORT 
card or the program to be 
used. 


1308-Record sort is in memory and a 
tag sort was requested. 2308-Tag 
sort is in memory and a record sort 
was requested. 

















See Note 1. If error repeats, 


x309 
mount a new SORTWORK 
disc and restart the sort. 
x310 Error when reading label or extent See Note 1. 
information from the input disc. 
x311 See Note 1. 
multicycle information from the in- 
put disc. 


Error detected on write to disc. See Note 1. 


x313 Disc malfunction on data read or | Press START to display 
write check. NNXX. Then press START 
to cancel ‘sort. 





Read error detected when reading 
own code from the checkpoint disc. 









Read error detected when reading 
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HALT NO. REASON ACTION 
Error when writing checkpoint to See Note 1. 
disc. 


x315 Multicycle indicator. The amount of | Press START to proceed. 
input exceeded the available work- 
ing storage. When this sort is ended, 
remount the input, work, and output 
discs on the same units and run the 
sort again with the same statement 
cards plus the MCYCL card. The re- 
maining records on the input file 
will then be sorted. Use the merge 
program to merge the sorted output 
files into one file. 


















Wrong input units specified for Press START to cancel. 
MCYCL run or the wrong work discs 


have been mounted. 


No input was received from IPRO. Press START to cancel. 


NOTE 1: Display format is nnxx. At some read and write error halts 
‘y the error number (nn) and the unit number (xx) will be 
‘ displayed by pressing START without a cancel keyin. 
Press START again to retry disc operation. 
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HALT NO. REASON 


x4uu The creation date or generation 
number on input unit uu does not 
match the information on the state- 
ment cards. 


See Note 2. 


ACTION 


Options: 















(1) Disregard halt and press 
START. The new value 
from the present input 
disc will be saved for 

comparisons on ensuing 

volumes, 








Mount the proper input 
disc, insert a nonzero 
keyin other than 01 and 
press START. 









(3) Insert a keyin of 01 to 
cancel, 














Mount the proper input and 
press START. 


The next volume of input is about 
to be read from unit uu, 





Options: 





Volume number not ascending order 
on unit uu. 










See x4uu. 






Mount the proper input disc, 
Press START to reread. 
Press or cancel. 


Improperly labeled input disc on 
unit uu. 






NOTE 2: All unit designations refer to 
logical unit numbers. 
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5.5. PHASE 2 DISPLAYS 


| PISPLAY 


oe Tag 
Sort Sort 


1801 2801 | Sort type indicated on checkpoint 
TAG SORT/RECORD SORT or 
MERGE. RECORD SORT/TAG 
SORT being run. 


18x0 28x0 | Disc error. x specifies error con- 
dition. 
Unrecoverable abnormal line 
Unrecoverable output bus check 
Catastrophic failure 
Nonoperational channel 
Invalid function 
Unload buffer not successful 
i 


Disc mounted on logical unit xx 
not a valid SORTWORK disc. 
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REASON ACTION 


Rerun sort with correct 
Phase 2. 


If START is pressed after 
errors 5, 7, or 8, sort is can- 
celled. If START is pressed 
after errors 1, 2, or F, disc 
operation will be retried. 
Enter a nonzero character 
into location 4 by means of 
the ALTER switch and press 
START to cancel the sort. 


Mount a valid SORTWORK 
disc on logical unit spe- 

fied and press START; or, 
enter a nonzero character into 
location 4 by means of the 

AL TER switch and press 
START to cancel the sort. 
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5.6. PHASE 3 DISPLAYS 


DISPLAY 





RECORD 
SORT 


1A01 2A01 


1A02 2A02 


REASON 


SORTWORK disc mounted on logi- 
cal unit specified by halt 1Cxx, 
1Dxx, or 1Exx is not a valid 
SORTWORK disc. 


Sort type indicated on checkpoint 
TAG SORT/RECORD SORT or 
MERGE. RECORD SORT/TAG 
SORT being run. 


Disc error. x specifies error con- 
dition. 


Unrecoverable abnormal line 
Unrecoverable output bus 
check 
Catastrophic failure 
Nonoperational channel 

- Invalid function 
Unload buffer not successful 


Disc on logical unit xx does not 
contain correct checkpoint informa- 
tion. This halt will only occur 
during a restart operation. 












5 14 





SECTION: PAGE: 


ACTION 





Mount a valid SORTWORK disc 
on logical unit specified by 
previous halt and press START; 
or, enter a nonzero character 
into location 4 by means of the 
ALTER switch and press 
START to cancel the sort. 


Rerun sort with correct Phase 3. 


If START is pressed after 
errors 5, 7, or 8, SORT is can- 
celled. If START is pressed 
after errors 1, 2, or F, disc 
operation will be retried. Enter 
a nonzero character into loca- 
tion 4 by means of the ALTER 
‘switch and press START to 
cance] the sort. 


Mount the correct disc onto 
logical unit specified and press 
START, or enter a nonzero 
character into location 4 by 
means of the ALTER switch 
and press START to cancel 

the ‘sort. 
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DISPLAY REASON. ACTION 


RECORD TAG 
SORT SORT 


2Cxx 
2Dxx 
DE xx 

_ End of file on logical unit xx when 


IF xx 2F xx 
outputting final sorted file. 
1FFF 2FFF| End of record Sort/Tag sort. 
























If a SORTWORK disc is on 
logical unit specified, press 

START; or mount a SORTWORK 
disc and press START. 


Sort ready to output final se- 
quenced file on logical unit xx. 










Specified disc must be re- 
moved. Mount a SORTWORK 

| disc on which final output will 
be written on unit specified. 
Press START. 














Sort ready to output final se- 
quenced file on logical unit xx. 

Dismounted disc becomes check- 
point disc for a multicycle or re- 
start operation. 





Dismount filled disc and mount 
a SORTWORK disc on unit 
specified for continuation of 
output processing, Press 
START. 





End of volume on logical unit xx 
when outputting final sorted file. 






















Dismount final output disc. 
Press START. 


None required. 





See 
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5.7. PHASE 4 DISPLAYS } 


DISPLAY REASON ACTION 


33xx Invalid input creation date. 
34xx Invalid input generation number. 


Invalid volume number. 


Unrecoverable disc I/O error. Press START to cancel job. 


Press START to try again. 


Any nonzero keyin will can- 
cel job. 
3A00 
3A01 
3A02 


3A03 





Load new disc to output unit, 
press START. Key in any 
nonzero to cancel job. 


Invalid output disc. 


















Load new disc to input unit, 
press START. Key in any non- 
zero to cancel job. 







Invalid input label. 










Press START to force label. 
Replace disc and key in any 
nonzero to test new disc. 













Load new file to unit and press 
START. Key in any nonzero to 
cancel job, 


File loaded is Index Sequential or 
Sysfile, 

















Press START to merge file. 
Any nonzero keyin will cancel 
job. 


File loaded is not defined or 
direct access. 







Recoverable disc I/O error. 









Invalid initialization (Phase 0 Press START to cancel job. 
not properly executed or improper 
criteria used). 


















Cancel job requested, as result of | Press START to cancel job. 


‘sequence error. 














Read error noted, automatic can- Press START to cancel job. 
cellation requested by criteria. 







Press START to ignore 
error. Any nonzero keyin will 
cancel job. 


Read error noted, automatic ignore 
option requested by criteria, 
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3A04 End of volume noted on output. Load new work disc, press 
No alternate available. START to continue. 

3A05 Press START to skip record. 
Any nonzero keyin will can- 
cel job. 

3F xx Sequence error noted on input file. | Enter FF to drop out of se 
quence record and continue, 
Press START to cancel. 


3F FF End of job. 




























\Read error noted, automatic skip 
option requested by criteria. 












Place next sequential volume 
on unit displayed. Press 
START to continue. 


End of input volume noted. 
(Alternate unit available.) 






Place next sequential volume 
‘on unit displayed and press 
START to’ continue. 


End of input volume, no alternate 
unit available. 













Place new work disc on unit 
displayed, press START to 
continue. 


End of output volume noted, 
(Alternate unit is available.) 





















Press START for supervisor 
EOJ return. 
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